home *** CD-ROM | disk | FTP | other *** search
/ InfoMagic Standards 1994 January / InfoMagic Standards - January 1994.iso / iso / 9660 / rockrdge / rrg.11 / api.end.nr < prev    next >
Text File  |  1992-08-19  |  2KB  |  83 lines
  1. .sp
  2. .H 2 "Header"
  3. .sp
  4. .in 0
  5. .ft 3
  6. NAME
  7. .ft 1
  8. .br
  9. .in 2
  10. .ft 3
  11. cdrom.h 
  12. .ft 1
  13. - RRIP definitions
  14. .sp
  15. .in 0
  16. .ft 3
  17. SYNOPSIS
  18. .ft 1
  19. .in 2
  20. .ft 3
  21. .br
  22. #include <sys/cdrom.h>
  23. .sp
  24. .ft 1
  25. .in 0
  26. .ft 3
  27. DESCRIPTION
  28. .ft 1
  29. .in 2
  30. .br
  31. The
  32. .I cdrom.h\^
  33. header contains the RRIP constant definitions for the RRIP library functions.
  34. If XCDR is supported, this header file will also contain
  35. the XCDR constants and structure declarations for the XCDR library functions.
  36. .sp
  37. The function
  38. .I cd_setdevmap()\^
  39. uses the following values for the argument
  40. .I cmd:\^
  41. .sp
  42. .TS
  43. center;
  44. l l.
  45. CD_SETDMAP    Set device file mapping
  46. CD_UNSETDMAP    Unset device file mapping
  47. .TE
  48. .sp
  49. If an implementation imposes a limit on the number of device file mappings,
  50. they will be defined by the following symbolic name.
  51. The definition of this symbolic name may be omitted from
  52. .I <sys/cdrom.h>\^
  53. if the actual value of the limit is indeterminate but greater than
  54. the stated minimum.
  55. Applications should therefore only use this symbol in code
  56. conditionally compiled on the existence of this symbol.
  57. .sp
  58. .TS
  59. center;
  60. l l.
  61. Name    Minimum Acceptable Value
  62. \_    \_
  63. CD_MAXDMAP    50
  64. .TE
  65. .sp
  66. .sp
  67. .bp
  68. .sp
  69. .H 2 "Recommendations for CD-ROM Publishers"
  70. .sp
  71. Unless the CD-ROM is targetted at a specific collection of systems, the
  72. values for major and minor numbers of device files will not identify
  73. the correct values on the receiving system. 
  74. Also the range of values for device file major and minor numbers
  75. that a system can handle might be smaller than what can be recorded
  76. on the CD-ROM.
  77. When producing a CD-ROM to be used on various systems, it is recommended 
  78. that the publisher number the device major and minor numbers consecutively
  79. starting at 0 and provide the System Administrator with sufficient
  80. information to map each recorded major and minor number to the appropriate
  81. values for the target system.
  82. .sp
  83.